Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

SetTrackClipRgn

The SetTrackClipRgn function allows your application to set the clipping region of a track.

pascal void SetTrackClipRgn (Track theTrack, RgnHandle theClip);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

theClip

Contains a handle to the track's clipping region. Note that the Movie Toolbox makes a copy of this region. Your application must dispose of the region referred to by this parameter when you are done with it. Set this parameter to nil to disable clipping for the track.

DESCRIPTION

The clipping region is in the track's coordinate system. The Movie Toolbox applies the clipping region to a track before it applies the track's matrix.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

Memory Manager errors

SEE ALSO

You can get a track's clipping region by calling the GetTrackClipRgn function, which is described in the next section.